home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 32 / Mac Magazin and MacEasy Magazine CD - Issue 32.iso / Grafik & Text / speak-sentence-20 Folder / Speaking Readme next >
Text File  |  1997-02-02  |  5KB  |  112 lines
  1. Speech Manager BBEdit Extensions V2.00, Freeware                         2nd Feb. 1997
  2. Copyright © 1993-97, All Rights Reserved.
  3. By R. Mark Fleming, <MarkF@post.QueensU.CA>,  <http://macinfo.ccs.queensu.ca/mark/>
  4. Phone: (613) 545-2039,   S-Mail: 521 Albert Street, Kingston, Ontario, Canada, K7K 4M5
  5. =======================================================================================
  6.  
  7. Two BBEdit Extensions for speaking the selected text using Apple 
  8. Speech Manager.  Use the Apple's Speech Control panel to select the voice used 
  9. by these extensions. 
  10.  
  11. To Install: 
  12.     Quit BBEdit, if it is running, and place the "SpeakSentence.A" extension file in  
  13.     the "BBEdit Extensions" folder.
  14.  
  15. Under BBEdit you fill find two new item in the Extension Menu:
  16.  
  17. 1)    Speaking
  18.  
  19.     This is a simple extension that use Apple's new speech manager to 'Talk' 
  20.     the selected text. If no text is selected, then the whole document 
  21.     is spoken.
  22.                   
  23. 2)    Speaking with Dialog
  24.  
  25.     The user is presented with a dialog box with some limited control 
  26.     over how text is read. The Apple's Speech manager is used to 'Talk' 
  27.     the selected text. If no text is selected, then the whole document 
  28.     is spoken.
  29.     
  30.     * You can ask it to spell the text (use option key to default to 
  31.       spelling) or 'Talk' the text.
  32.     * You skip lines starting duplicate sequences of  '/', '=', '-', '_', or '*' with or 
  33.       without spaces between them.  Plus lines tarting with /* or // (ie. C and C++ comments).
  34.       it also skip lines ending with sequence of characters. Lines with text before and after the
  35.       sequence of characters are not skipped.
  36.     * You can use the Talk, Stop, Pause, and Continue buttons to 
  37.       control and replay the text.
  38.     * Spell/Talk check button is disabled while talking. If you pause 
  39.       it, the button is enable, but will only take effect if you press 
  40.       the talk button which starts talking from the start.
  41.     * The exit button is used to return to BBEdit.
  42.  
  43. BBEdit Error Reporting:
  44.     
  45. If a Speech Manager error occures BBEdit and BBEdit lite will display one of the  
  46. following error numbers:
  47.                 
  48.  noSynthFound         = -240,    //    Speech Manager errors
  49.  synthOpenFailed    = -241,
  50.  synthNotReady        = -242,
  51.  bufTooSmall        = -243,
  52.  voiceNotFound        = -244,
  53.  incompatibleVoice    = -245,
  54.  badDictFormat        = -246,
  55.  badInputText        = -247    //    The error message numbers are from the Speech.h:
  56.  
  57. History...
  58. Version 1.00    Release “Speaking sentences” & “Speaking” module.
  59. Version 1.10    Fix bug were no female voice is installed (error -244). 
  60.                 Added tracking of text being spoken.
  61.                 Merged both modules into on file: “Speaking”.
  62.                 If option key is depressed, the default is change to spelling 
  63.                 selected text.
  64. Version 1.11    Fix bug when selected text is scrolled into view. 
  65.                 Add correct version resource for Finder's GetInfo... 
  66. Version 1.20    Cleaned up source code to be included with modules.  
  67.                 Feel free to enhance these modules... but give credit were credit 
  68.                 is due (and send me updated source, so I can add it to any 
  69.                 changes I do!).
  70. Version 1.21    Change all NewHandle() calls to callback-Allocate() calls.
  71.                 Free memory allocated when error occures when allocating speech 
  72.                 channel.
  73.                 #ifdef StackDebug code to check stack space problem (OS Error 28).
  74. Version 1.22    Converted to Codewarrior Compiler. 
  75.                 Cleaned up code to remove global variables.
  76.                 Disabled Spelling/Talk button in the dialog when talking.
  77. Version 1.23    Added Resource to tell BBEdit 3.0 stop undo message (Not released)
  78. Version 1.24    Added an option to set default voice name as named in resource STR#
  79.                 128, index 1 Matching is done with the "starts with" and is NOT 
  80.                 case sensitive. (Yes a POP menu would be nice, but this was quicker 
  81.                 to do, maybe later).
  82. Version 1.25    Change STR# 128 voice matching code to look for any Voice matching in
  83.                 the STR#. Check in order (index 1 is prefered over index 2, etc...).
  84.  
  85. March 1st, 1996
  86. Version 1.3        Added support for selecting the voice used from the Speech Control panel. 
  87.                 If this voice can not be found, it falls back on the defaults used in V1.25
  88. Version 1.31    Add Balloon Help to the Dialog
  89.  
  90. Feb 1st, 1997
  91. Version 2.00    Added code that does not speak repeated characters at the start or end of a line.
  92.                 Selectable in the Speaking with Dialog version of the BBEdit extension.
  93.  
  94. Known Problem:
  95. *    System Error 28 - Stack has moved into application heap occurs on some machines.
  96.                       I have been unable to prevent this in older version of Speech
  97.                       manger, during the process of starting the speech manager, 
  98.                       it is using up all the stack space.
  99.  
  100. **    Mark Fleming, The Author of: several utilites such as:
  101.     Apple Media Tool (AMT) FAQ, AMT Extensions,
  102.     Mark's Translators, a set of graphical translator (PNG, TIFF, BMP, WMF, 
  103.     MacPaint, EPS previews, etc...); NetDoctor,  a Lab and Network 
  104.     Maintainer Package, and AppleGuide extension to Omnis7. 
  105.  
  106.     For more information check out the following WWW page:     
  107.         http://macinfo.ccs.queensu.ca/Mark/
  108. **
  109.  
  110. Disclaimer: Use these extension at your own risk. 
  111.  
  112.